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[1]RFCI951 

[2] 

[3] 



"DEFLATE Compressed Data Format Specification version 1 .3 
MediaHighway+ : Gestionnaire de fichiers en FLASH. 
MediaHighway+ : Gestionnaire de tdlechargement. 



lo2 T©]riiimm(D)B<D)gne 



Un volume represente Torganisation de Tensembie des fichiers disponibles sur un support donne. Le support peut etre 
local (m^moire RAM, FLASH ou ROM) ou exteme (volume mont^ par I^intermediaire d'un p^ripherique). 

Un volume est organise sous la forme d'un arbre avec un directory racine et des sous-directories. Le nombre de niveaux 
d*arborescence n'est pas limite. Chaque directory represente un noeud de Tarbre. 



13 L© gygtegM© d© ffncItaB©rs 

1.3.1 Les volumes 

Bien que le terminal ne possede pas de disque dxir, un syst^me de fichiers local est impl^mente. Les fichiers sont stockes 
dans les differentes memoires du terminal. Les fichiers sont organises en volumes. II existe un volume dans chaque 
support m^moire : RAM, FLASH et ROM, ^organisation des donn^es est specifique du support du volume. 

Si le terminal ne comporte pas de ROM mais seulement de la memoire FLASH, 2 volumes y sont stockes : le volume 
ROM est non modifiable tandis que le volume FLASH est modifiable. 

Le systdme de fichiers peut egalement comporter un volume particulier appele TRANSIENT, dont les donnees sont en 
RAM. Ce volume est utilise pour rnipl^menter la fonctionnalite "persistent storage" de la norme MHEG5. Une zone 
, memoire de taille fixe est r^serv^e pour stocker les donnees des fichiers du volume. Cette zone est geree comme une 
FIFO : Les fichiers les plus anciens sont supprim^s au fur et ^ mesure pour faire place aux donnees des nouveaux 
fichiers stockes. 

Un volxmie mont^ represente les fichiers disponibles sur un m^dia de t^lechargement. Ces fichiers peuvent etre 
telecharges dans le terminal. lis peuvent ^ventueliement etre transfer's dans le volume RAM ou FLASH. 

Au demarrage du terminal, le systeme de fichiers est dans Tetat suivant : 

o Le volume ROM est immediatement disponible. II d'crit tous les fichiers residents. 

o La description de Tarborescence du volume FLASH est cr'ee en RAM en fonction du contenu de la FLASH. 

o Le volume RAM est vide. 

o Le volume TRANSIENT est vide. 

o II n'existe aucun volume monte. 

1 .3.2 Les fichiers et les directories 



© Copyright CANAL + 1996 

Ce document ne peut etre communique k des tiers sans autorisation ^crite prealable des ayants droits. 



page 5/28 



TV NUMERIQUE ET 
INTERACTIVITE 



05/06/98 



Chaque fichier ou directory est decrit par les informations suivantes : 

0 Son nom. . ^ 

1 t^r^/T'"^. " '1^' "^'"^ ^ representant le code de Toperateur (OPO qui a genere le fichier 
o Ses droits d'acc^s en lecture et en ecriture (3 fois 2 bits) pour : ^ ^ M genere ie richier. 

o Le proprietaire. 

o Les operateurs appartenant au meme groupe que le proprietaire. 
o Les operateurs n'appartenant pas au meme groupe. 
o Des attributs : 

o Type de I'entite : fichier ou directory. 

° " """^ .«*ch.,gfe, si d„„„e„ ^s<.«.s i l-e„,i« son, „cessib,es 

Certains fichiers peuvent exister dans plusieurs volumes. On considSre alors que la version du fichier situfe H.n. i 
volume le plus "volatile" masque la version du fichier contenue dans le volume le moils^ioladL' A^si 

S^sr~'. ''r'"' '""^ '"^'"^ '^^^'^^^'^ - '^LASH ou e^ROM De mime ' " fichL" " 

FLASH masque le fichier du mSme nom situ6 dans le meme directory en ROM. Un fichier peut ^ealement^xSS 

1 .3.3 Services propn^^c par le gestionnaire de fichipr 

o Ouverture d*un fichier en mode "read". 

o Ouverture djun fichier en mode "write", "append" ou "update" (uniquement sur les volumes RAM et FLASH) 
o Lecture de donn^es dans un fichier. ri.Aj>n;. 

o Ecriture de donndes dans un fichier (uniquement sur les volumes RAM et FLASH) 

o Fermeture d*un fichier. 

o Creation d'un directory. 

o Copie de fichier ou de directory. 

o D^placement/renommage d*un fichier ou d'un directory. 

o Suppression d'un fichier ou d'un directory. 

o Foumiture d'informations sur un fichier. 

o Montage/demontage d'un volume. 

^ Telechargement de fichiers et de directories. 
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directory 
I I fichier 



Figure 1 : Description de Tarborescence d'un volume. 



1.3.4 Structures de description des fichiers et directories 

La description de rarborescence des directories et des fichiers est identique pour tons les volumes. 
Les descripteurs des directories et des fichiers sont stock^es : 

• En ROM pour le volume ROM 

• Dans le pool statique de la memoire pour les autres volumes 



Chaque volume contient une entity racine de type directory. Toutes ces entites sont elles-meme contenues dans un 
directory racine general. 
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Figure 2 : Racine de I'arborescence. 



1.3.4.1 Descripteur d'une entite de type directory 



Champ 
FsDirEntry { 
Parent 


Type 

FsDirEntry * 


Description 

Adresse du descripteur du directory auqueT 
appartient I'entite 


Name Address 
Owner 


Char* 

Unsigned short 


Adresse de la zone memoire contenant le nom de 
Fentite. 


Group 

AccessMode 
Attributes 


Unsigned char 

Unsigned char 
Unsigned char 


Numdro identifiant le propri^taire de Fentite 
Num^ro identifiant le groupe auquel appartient le 
fichier. 

Droits d*accds associds. 


EntryCount 
EntryCapacity 


Unsigned short 
Unsigned short 


Type et attributs de Tentite. 
Nombre d*entites contenues dans le directory 
Nombre d'entit^s maximum que peut contenir la liste 
d'adresses des entites. 


Entry List 


FsEntty * [ ] 


Liste de pointeurs sur les descripteurs des entites 
contenues dans le directory. Les pointeurs sont 
classes suivant I'ordre alphabetique des entites 
pointees. 


blockCount 


Unsigned short 


Nombre de descripteurs des blocs de donnees des 
fichiers du directory. 


blockCapacity 


Unsigned short 


Nombre maximum d'elements que peut contenir la 
liste des descripteurs de blocs de donnees. 


blocIcList 


FiIeBlock[ ] 


Liste des descnpteurs de blocs de donnees des 
fichiers du directory. 
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Bescripteur d'une entite detypejichier 



Champ 


Tvne 


uescripiion 


FsFileEntry { 






Parent 




— - — ' — . 

Adresse du descripteur du directory auquei 
appartient I'entite 


NameAddress 


Char* 


Adresse de la zone memoire contenant le nom de 
Tentit^. 


Owner 


Unsigned short 


Numero identifiant le proprietaire de I'entite. 


Group 


Unsigned char 


Numero identiflrifit Ip prmmp ^wcxwfA ^i^nn^rtioni' 1a 
fichier. 


AccessMode 


Unsigned char 


Droits d*acces associes. 


Attributes 


Unsigned char 


Type et attributs de I'entite. 


blocklndex 


Unsigned short 


Indice du descripteur du premier bloc de donnees du 
fichier dans la liste des descripteurs de blocs 
associ^e au directory auquei appartient le fichier. 


blockCount 


Unsigned short 


Nombre de descripteurs des blocs de donnees du 
fichier. 


} 







13,43 Descripteur d^un bloc de donnees d^un fichier 



Champ 


Type 


Description 


FileBIock { 






DataAddress 


Unsigned Char * 


Adresse de la zone memoire contenant !es donnees 
du bloc. 


Size 


Unsigned int 


Taille du bloc de donnees en octets. 


} 







104 IL© V(Dfliinm© MOM 

Le volume ROM est constitue de tableaux et structures statiques. Les fichiers et les directories qu'il contient sent 
accessibles uniquement en lecture. 

105 vcpBiflm© FLASH 

La gestion des donnees dans le volume FLASH est d^crite en d^ail dans le document [2]. 

1.5.1 Initialisation du volume FLASH 

A rinitialisation du terminal, le gestionnaire de fichiers appelle le gestionnaire de FLASH pour lui demander de 
construire la description de son arborescence. Le gestionnaire de FLASH parcourt toutes les donnees stockees en 
FLASH et cree un descripteur pour chaque fichier et chaque directory. 

1 .5.2 Description en RAM de Tarborescence du volume FLASH 

La description en memoire contient des pointeurs directs sur les noms et sur les donnees des entites situees en FLASH. 
Par ailleurs, le gestionnaire de FLASH memorise pour chaque entite stokee en FLASH Tadresse de son descripteur. 
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di^LtSrJSr ^^^^^^ -o-' (recop. .«e p.,, 

des entiles deplacees. J""' '^^ pointeurs ccmfenus dans les descripteurs 




Figure 3 : References crois^es entre les donn6es en FLASH et les descripteurs de ces donnees 

1 .5.3 Modification du volume FLASH 

Pendant une operation d'^critu^rFLASH t S modifications sur le volume FLASH en parallfele. 

protege par un moniteur. ' " ^"^''^^le en lecture. L'acces i la FiTasH est 

lo6 IL© volnnme IRAM 

o Ouverture de fichier en ecriture. 

° Copie de fichiers ou d'arborescence 4 partir d'un autre volume. 



lo7 ]L© voflnflme T1RANSIENT 



ury racme ( 1 1 KANSIENT ). Ce du^ectory contient uniquement des fichiers. 

Us fichiers son, classes du plu 2SrafSe„?LTa^rZ" T""" "T"""' "o™*" "'"i^'^- 
s«n..«c™«,_„,s„ppl.,s,ns,.fappS„^orp^^^^^^^ 
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Les fichiers sont Merits en une seule operation grace ^ une fonction d'interface particuJi^re (MhwFsStorePersistent). 
Cette meme fonction peut egalement etre utilis^e pour ^eraser le contenu d'un flchier existant. Un fichier dont le contenu 
est ^crase est reclass^ comme ^tant le fichier le plus recent. Les fichiers peuvent etre lus en utilisant la fonction 
MhwFsReadPersistent. 



lo8 Votameg inmdDmtes 

Un volume mont^ repr^sente des donnees tel^chargees par rintermediaire d*un periph^rique. Une fois telecharg^es, les 
donnees sont decrites par une arborescence comme pour les volumes locaux. Les donnees des volumes montes sont 
accessibles en lecture uniquement. 

II existe 5 periphdriques de t^l^chargement dans le terminal : 

o demultiplexeur MPEG. 

o portRS232. 

o port Centronics. 

o lecteur de carte ISO 78 1 6. 

o modem 

Pour acc^der a un volume distant, une application doit demander le tel^chargement des donnees du volume dans le 
terminal. Ce t^lechargement s'efFectue par Stapes et dans un ordre qui n*est pas totalement quelconque. La premiere 
operation consiste a tel^charger le directory racine du volume. 

La gestion du t^l^chargement est d^crite en detail dans le docimient [3]. 

1.8.1 Organisation d'un volume telechargeable 

Sur un m^dia de t^l^chargement, les donnees d*un meme volimies sont r^parties en plusieurs blocs appel^s "modules". 
Chaque module contient la description d*une arborescence. Le premier module du volume contient la description de la 
racine de I'arborescence du volume. 

La figure suivante illustre I'organisation generate des donnees : Chaque module contient un descripteur pour chaque 
entity fichier ou directory. Les donnees associ^es k chaque entity peuvent etre contenues soit dans le meme module, soit 
dans un autre module. 



© Copyright CANAL + 1996 page 1 1/28 

Ce document ne peut etre conmiuniqu^ a des tiers sans autorisation ecrite prealable des ayants droits. 



TV NUMERIQUE ET 
INTERACTIVITE 



05/06/98 



DTIyMH4-/jfb/980000/l .o/jpB 




Figure 4 : Organisation des donnees sur le media de telechargement, 

L8.2 Telechargement de donnep*;: 

Le telechargement est line operation asynchrone. 

'^oZrS:^^:::^^^^^^^ ^"7—^ ^^'^charg. ,e pre™-, .odu.e du 

telechargement est tennin/e cerentS^^^^^^^ ""^T ''^P^^^^" 

par le gestionnaire airectory racine du volume. Ce directory racine est cree 



J. 8,2, 1 Montage d 'an volume 

dl^r^^^^ ^""^"^^ '"''""'"^^ ^ demander le telechargement du 



monl!r n""' ^^^f' P'^''^^'" ^^"'"^ P^"^^^"^^ ^^^^^s en parallele 

monter qu*un seul volume k la fois. H^^^^^cic 



premier module d'un volume sur un peripherique 
Sur les autres peripheriques, on ne peut 
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Des la reception des donn^es du module, les donn^es sont analysees. On v^rifie leur coherence et eventuellement leur 
authenticity. On cr^e les descripteurs de toutes les entries contenues dans le module pour constituer une arborescence. 



1.8.2,2 Telechargement d^un fichier ou d^un directory 

Lorsqu'un volume a ete mont^, les entites du module re^u peuvent contenir des references vers d'autres modules. 

Des la reception des donnees du module, les donn^es sont analysees. On v^rifie leur coherence et eventuellement leur 

authenticity. On cree les descripteurs de toutes les entries contenues dans le module pour constituer une arborescence. 



1.8.2.3 Demoniage d^un volume 

Le d^montage d'un volume entraine les actions suivantes : 
o Suppression de la description de Tarborescence du volume, 
o Suppression de toutes les donnees associ^es aux fichiers. 
o Suppression du contexte de telechargement. 



lo9 Acces aiiinx lEncMeo 



Tous les fichiers situes dans un volume et dont les donnees sont pr^sentes dans le terminal doivent etre accessibles par 
Tapplication par rintermediaire d'une interface generalisee. 

L'interface propos^e est classique et contient les fonctions suivantes : 
o Ouverture du fichier dans Tun des modes suivants : , 

o Read 

o Write 

o Append 

o Update 
o Lecture de donnees. 

o Ecriture de donnees si le fichier est situ^ dans le volume RAM ou FLASH. 
0 Positionnement du pointeur de lecture/6criture. 
o Fermeture du fichier. 

Plusieurs versions du meme fichier (meme nom et meme chemin d'acces) peuvent se trouver dans diff^rents volumes a 
un instant donn^. En g^n^ral, Tapplication ne sait pas dans quel volume se trouve le fichier k charger. Le nom du fichier 
a rechercher est alors donn^ sans indication du volume (exemple : "stb/device/Mload.class"). Dans ce cas, le fichier doit 
etre cherchd dans les diff^rents volumes accessibles en commen^ant par le dernier volume qui a ete monte 
(chronologiquement), en continuant par les autres volumes montes puis le volume RAM, le volume FLASH et enfm le 
volume ROM. Des que le fichier a ete trouve, la recherche s'arrete. 

II est toutefois possible d'indiquer precisement le volume dans lequel se trouve le fichier en ajoutant le nom du volume 
en tete du chemin. Les volumes locaux sont nommes "ROM", "FLASH" et "RAM". Chaque volume monte possede un 
nom qui pourra etre donne par Tapplication ou attribue automatiquement (exemple "DSMCCl" ...). Pour indiquer que 
ie chemin est donne en absolu, on le fera debuter par un caract^re "/" (exemple : "/ROM/stb/device/Mload.class"). 

Lorsque le fichier est ouvert en ecriture, il est bien sur obligatoire d*indiquer le chemin absolu du directory dans lequel il 
doit etre ecrit (bien que seule soit autorisee recriture dans le volume RAM ou FLASH). 
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Figure 5 : Recherche du fichier "B1/D2/D4/D5/F5" au travers de differents volumes 



1 .9. 1 Descripteur d'un flux de donnee^; 



Champ 



FileStream i 



Entry 



OpenMode 



Flags 



StreamPointer 



CurrentBuffer 



currentBlockPointer 



currentB lockLength 



currentB locklndex 



deviceContext 



inflateContext 



'Type 



FsEntry 



Unsigned char 



Unsigned char 



Unsigned int 



Unsigned char* 



Unsigned int 



Unsigned int 



Unsigned short 



Void 



InflateCtx * 



Description 



Adresse du descripteur du fichier. 



Mode d'ouverture du fichier 



Flags internes. 



Pointeur de lecture/ecriture sur le flux exteme. 



Adresse du bloc de donn^es courant (flux interne). 



Pointeur de lecture/ecriture dans le bloc courant 
(flux interne). 



Taille en octets du bloc de donnees courant (flux 
jnteme). 



Lidice du bloc de donnees courant. 



Adresse d'un contexte specifique (utilise par le 
gestionnaire de FLASH). 



Adresse du contexte de decompression (flux en 
lecture uniquement). 
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1 .9.2 Ouverture d'un fichier en lecture 



1,9.2.1 Flwc de donnees en lecture 

Une fois ouvert, un fichier est vu comme un flux de donnees, Uacces est en general s^quentie! mais il est possible 
d*acceder directement a une position precise dans le flux de donnees, 

Un contexte est cree pour controler le flux de donnees. Dans le cas ou le fichier n'est pas compresse, il y a un seul flux 
de donnees (flux interne flux exteme). Dans le cas ou les donnees sont compresses, il y a 2 flux de donnees : Le flux 
de donnees brut (flux interne) et le flux de donnees decompressees (flux exteme). Dans ce dernier cas, un contexte 
supplementaire est necessaire pour gerer la decompression. 

Dans un syst^me de fichiers classique sur disque, les donnees sont en general lues bloc par bloc et stockees dans un 
buffer d*anticipation. Dans notre systeme de fichiers, dans le flux de donnees d'un fichier ouvert, k tout moment, un 
certain nombre d'octets sont disponibles directement et sequentiellement. Lorsque tous ces octets ont ^t^ lus par 
Tapplication, les donnees suivantes sont pr^par^es. 



flux d^compress^ 




fenfitre de decompression 



pointeun de lecture 






contexte de decompression 



pointeur de lecture 



bloc courant 



d^but du ftchier 
,brut 







pointeui 



lecture 



flux brut 



Figure 6 : Flux de donnees en lecture sur un fichier compresse. 



1 .93 Ouverture d'un fichier en ecriture 
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chemin doit debater p J la cLtoe -^^^^^^^ '"'"'"^ ^'^'^'^^ ^^LASH. Le nom du 

Trois modes d'ouverture sont proposes : 

° "write" : ouverture d'un nouveau fichier ou ecrasement d'un fichier existant 

o append" : ecriture de donndes k la suite des donnees d'un fichier existant 

o update" : remplacement de donnees ou ajout de nouvelles donndes dans un fichier existant. 

Les modes "append" et "update" sont autorises uniquement si le fichier existe ddja. 

L'ecriture avec compression n'est pas supportee. 

1.9.3.1 Flux de donnees en ecriture 

Si 1= Hchi^r es, e„ FLASH. lo,^„e le buffer e«u™, es. piein, <», .|,o„e sm.ple™M on „„„v«,u buffer. 

L'ecriture du buffer doit dgalement Sfre ddclench^e la 1™^^,. Tr k . ? '^^ nouvelles donnees. 

ecrit en FLASH pourra aLi etre co^sJtu de^'^^^^^^ - -et. Le fichier 

descripteurdu directory destinataireau fur et^mesuredTleur Srit^e. ni6monsees dans le 

1. 9.3. 2 Positionnement du poinieur d'ecriture 

Si la nouveile position correspond 4 un octet qui a d6ja €t€ terit, il faut dans Tordre • 

° Vider le contenu du buffer d'anticipation en dcrivant en FLASH les octets qu'il contient 

dSls j^iSrs.''"'""''^'"" '^^ ^-^^^^ co^espondant si la position choisie correspond a des 

° Mettre a jour les pointeurs d'ecriture relatif et absolu du flux. 
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1.10.1 MhwFsInit 



SYNTAXE D'APPEL 

int MhwFsInit ( int aDebugLevel ); 



ARGUMENTS D'ENTREE 
aDebugLevel 

Niveau ddsir^ de traces de mise au point (0 = sans traces). 

DESCRIPTION 

Cette fonction initialise le gestionnaire de fichiers. 



1.10.2 MhwFsAttach 



SYNTAXE D'APPEL 

int MhwFsAttach ( char * aVoIume , Int32 aDevice, MhwI>wnSGAddress *anSGAdress, 

MhwDwnModAddress *anSGModuleAddress, Int32 Authentication, MhwDvmVerParara 
*aMonitoringDescriptor); 

ARGUMENTS D'ENTREE 
aVolume 

nom du volume i creer. 
aDevice 

Ce champ contient le port de communication physique ou se trouve le Service Gateway k t^l^charger. 
Les valeurs possibles pour ce champ sont: 

DEV_MPEG 

DEV_SERIE 

DEV_PARALLELE 

DEVJS07816 

DEV_MODEM 

anSGAddress 

Ce champ contient Tadresse du Service Gateway sur lequel on va se connecter. La description 
complete est dormee dans la documentation de la fonction MhwDvmGCAttachGateway (Gestionnaire 
de t^lechargement). 
anSGModuleAddress 

Ce champ contient les donn^es n^cessaires pour le chargement antic ipe du module contenant le 
ServiceGateway. Si ce champ vaut NULL, le mode anticipe n'est pas utilise. La description complete 
est donn^e dans la documentation de la fonction MhwDwnGCAttachGateway (Gestionnaire de 
tel^chargement). 
Authentiflcation 

Ce champ contient un flag indiquant si Ton desire verifier la signature des modules t^l^charg^s. 
AUTH_ON 

La verification de signature est activee. Tous modules sans signature ou avec une signature 
incorrecte seront rejetes. 
AUTH_OFF 

Les signatures ne sont pas verifi^es. 
AMonitoringDescri ptor 

Ce champ decrit le mode de surveillance des versions des modules. La description complete est 
donnee dans la documentation de la fonction MhwDwnGCAttachGateway (Gestionnaire de 
tel^chargement). 

VALEUR DE RETOUR 

Si Top^ration est accept^e, la fonction rend un identifiant de chargement positif ou nul. 
Si I'operation est refus^e, la fonction rend Tun des codes d*erreur suivants : 
ERR_FS_MEMORY : Echec deallocation memoire. 

ERR_FS_ALREADY_ATTACHED : II existe deja un volume portant ce nom. 
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Autres codes d'erreur rendus par la fonction MhwDwnGCAttachGateway. 
DESCRIPTION 

"FLASH- son, te.rdte. Le „„„, „ doi, coTtLr.iTc^^.ij.r"" ^NSIENT" „ 

demandee. " " 1ACH_TYPE est genere pour indiquer la fin de reparation 

Le code de I'evenement est ridentifiant de chargement rendu par la fonction. 

E^-J^min 'Iffn'i?.^! '^^^"'"^ correctemem. 

ERR_PS_LOAO_PAILED:Lecharge.entn.apu.tree.ectu.(ti.eoutou.^^^ 
1.10.3 MhwFsDetarh 

SYNTAXE D'APPEL 

int MhwFsDetach( char « aVolume ); 

ARGUMENTS D'ENTREE 
aVoIume 

nom du volume a d^monter. 

DESCRIPTION 

VALEUR DE RETOUR 

ERR NONE : L'operation est acceptee 

ERR_PS NOT_ATTACHED : Le volume indique n'existe oas 

Autres codes d'erreurs rendus par la fonction N^woSeichGateway. 

1.10.4 MhwFsDnwnl^aH 

SYNTAXE D'APPEL 

int MhwFsDownload ( char * aPath ); 

ARGUMENTS DENTREE 
aPath 

chemin d'acces du fichier ou du directorv I p rHAr«;« a* x 
VALEUR DE RPTOUR 

E^>|>AtT"^ ^ E;he?d?;Sn Xt^e"'^^ ' ^^^"^ ^"^^^^ ^ 
Autres codes d en-eur rendus par la fonction MhwEKvnGCGetSbject. 
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DESCRIPTION 

Cette fonction permet de demander le t^l^chargement d'un fichier ou d'un directory. 

L*op6ration est asynchrone. Elle peut engendrer un ou plusieurs chargements de modules pour acceder aux 
donnees. Un ^v^nement de type MHW_EVT_FSOPEN_^TYPE est g^n^r^ pour indiquer la fin de reparation 
demand^e. Le code de Tev^nement est I'identifiant rendu par la fonction. 

L'evenement contient un code d'erreur qui vaut : 
ERR_NONE : si Toperation s'est derouiee correctement, 

ERR_FS_LOAD_FAILED : Le chargement n'a pu etre effectu6 (timeout ou manque de ressource physique). 

1.10.5 MhwFsLoadAbort 

SYNTAXE D'APPEL 

int MhwFsLoadAbort ( Int32 Id ); 

ARGUMENTS D'ENTREE 
Id 

Identifiant de chargement rendu par !a fonction MhwFsDownload. 

VALEUR DE RETOUR 

En retour, la fonction rend : 
ERR_NONE : L'operation est accept^e. 

ERR_FS_NO_SUCH_LOADING : L'identifiant de chargement est inconnu. 
Autres codes d'erreur rendus par la fonction MhwDwnGCAbort. 

DESCRIPTION 

Cette fonction permet d*aborter une demande de t^l^chargement initio par Tappel de la fonction 
MhwFsDownload. 

1.10.6 MhwFsRemove 

SYNTAXE D'APPEL 

int MhwFsRemove ( char * aPath ); 

ARGUMENTS D'ENTREE 
aPath 

chemin du fichier ou directory a supprimer. Le chemin doit d^buter par le caract^re T, suivi du nom du 
volume (exemple "/RAM/...."). II est impossible de supprimer un fichier ou im directory dans le 
volume ROM. 

VALEUR DE RETOUR 

ERR NONE : pas d^erreur 

ERR_FS_PATH_NOT_FOUND : le chemin d'acc^s n'existe pas. 

ERR_FS_ACCESS_DENIED : Tacces en Venture au directory parent ou k Tun des sous-directories est refuse. 
DESCRIPTION 

Cette fonction supprime le fichier ou !e directory dont on donne le chemin d'accds. Elle supprime egalement 
tous les sous-directories si le chemin indiqu6 repr^sente un directory. Le chemin doit etre donne en absolu et 
d6buter par le nom du volume contenant le fichier ou directory. II peut s'agir du volume RAM, du volume 
FLASH ou d'un volume mont6. 

1.10.7 MhwFsCreateDirectorv 

SVNTAXE D'APPEL 
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int MhwFsCreateDirectory ( char * aPath ); 

ARGUMENTS D'ENTREE 
aPath 

chemin du directory h creer. Le chemin doit debuter par le caract^re r ^.nVi Hn « a 
(exen.pIe"/RAM/.../O.I,est impossible decreerur^d^^^^^^^^ "^"^ 

VALEUR DE RETOUR 

ERR NONE : pas d'erreur 

ERR F?-Mo5 f f?^?™ - ' ^" ^^"^^ ^" parent est refuse. 

d^^^-rsVS™^ ^ ^'^"^ ^'^"^^ ^''--'^ P-- - correspond pas . u„ 

DESCRIPTION 

Ste^-pit Zt "^^n^^;^^;^^ - a.so. et 

Tous les directories intenn.diaires .entionn.s dansTe cheS dSes doTvlTex^e^ °" 

1.10.8 MhwFsCopY 

SYNTAXE D'APPEL 

int MhwFsCopy ( char » aSourcePath , char * aDestinationPath ); 

ARGUMENTS D'ENTREE 
aSourcePath 

volume. ^ repr^senter un fichier ou un directory situe dans n'importe quel 

aDestinationPath 

VALEUR DE RETOUR 

ERR NONE : pas d'erreur 

ES-F^AcSifDfN?J^'° ■ ^^o" destination n'existe pas. 

s™ d'd.5!o5^e. - ^"^^ ^" ^'^"^^ -fi'^^ - directory destination ol acc^s en lecture refus. 

F??-F?-iJ?i'^'^^ '■ "'allocation m^moire pour la copie. 
ERR_FS_NOT_A_DIRECTORY : Le chemin destination represents un fichier existant. 

DESCRIPTION 

Cette fonction copie un fichier ou un directory et toute I'arborescence qui en depend. 

exit?" "''^'^^"^^^ '^-^'"'^ ou une entree non existante dans un directory 

'^Tx^t^j::z!^:.'z^:;i^^''- ^^^^ ^'^-^ ^^--^o" -t situ, dans le 

1.10.9 MhwFsMove 

SYNTAXE D'APPEL 

int MhwFsMove ( char * aSourcePath . char * aDestinationPath ); 
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ARGUMENTS D'ENTREE 
aDi rectory 



chemin actuel du fichier ou directory. Le chemin doit d^buter par le caractdre 7, suivi du nom du 
volume (exemple "/RAM/...."). 



aDestinationPath 



chemin du fichier ou directory destination. Le chemin doit debuter par le caractere 7, suivi du nom du 
volume (exemple "/RAM/...."). 



VALEUR DE RETOUR 

ERR_NONE : pas d'erreur 

ERR_FS_PATH_NOT_FOUND ; le chemin d'accds source et/ou destination n'existe pas. 
ERR_FS_ACCESS_DENIED : acces en ^criture refuse sur ie directory destination ou sur le directory source. 
ERR_FS_MEMORY : ^chec deallocation memoire. 

ERR_FS_DUPLICATE_NAME : II existe d€jk une entree du meme nom dans le directory destination. 
DESCRIPTION 

Cette fonction d^place un fichier ou un directory et toute Tarborescence qui en depend. 



Le chemin destination doit representer un directory existant ou une entree non existante dans un directory 
existant. S'il existe deja une entree du meme nom dans le directory destination, I'operation est refusee. Si les 
directories source et destination sont identiques, Top^ration se resume a un changement de nom. Sinon, 
Fentree representee par le chemin source est retiree du directory qui la contient pour etre ajoutee au directory 
destination. 

Les chemins doivent etre donnas en absolu. Les directories source et destination doivent etre situes dans le 
meme voiume.L'op^ration est permise uniquement dans le volume RAM et dans le volume FLASH. 



1.10.10 MhwFsGetFileList 

SYNTAXE D'APPEL 

int MhwFsGetFileList ( char * aPath , char *aFilter , int aMode , char aList ); 

ARGUMENTS DTNTREE 
aPath 

chemin du directory. Le chemin pent etre donn^ en absolu ou en relatif. 

aFilter 

filtre de selection des fichiers. II s*agit d'une chaine de caracteres qui peut contenir le caractere qui 
represente un nombre quelconque d'occurrences de n*importe que! caractere et le caractere '?* qui 
repr^sente une occurrence de n*importe quel caractere. Si la valeur du paramdtre est un pointeur nul ou 
une chauie vide, aucun filtrage n'est effectu^ sur les noms. 
Exemples : "*.c!ass" , , "*.*" , "ab?d.e?". 



aMode 

ce parametre indique si les extensions doivent etre conservees dans la liste des noms selectionnes. II 
peut prendre Tune des 2 valeurs suivantes : 

MHW_FS_KEEP_EXTENSIONS : les extensions sont conservees. 
MHW_FS_DONT_KEEP_EXTENSIONS : les extensions ne sont pas conservees. 



ARGUMENTS DE SORTIE 
aList 



buffer allou^ par la fonction contenant la liste des noms des fichiers ou sous-directories du directory 
s^pares par des line-feed (code ascii 10). En cas d'erreur ou dans le cas ou la liste est vide (c'est a dire 
si le directory ne contient aucun fichier dont le nom satisfait le critere specific par le filtre), la valeur 
du parametre est NULL. 



VALEUR DE RETOUR 

Si pas d'erreur : Nombre de fichiers composant la liste. 
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ERR_FS_MEMORY : echec d'allocation memoire. 



DESCRIPTION 

1.10.11 MhwF<;Fil^Fvict 

SYNTAXE D'APPEL 

boolean MhwFsFileExist ( char * aPath ); 

ARGUMENTS D'ENTREE 
aPath 

chemin d'acces du fichier ou du directory. Le chemin peut etre donne en relatif ou en absolu. 
VALEUR DE RETOUR 

TRUE si le fichier/directory existe, FALSE sinon. 

DESCRIPTION 

1-10.12 MhwFQTcFn^ 

SYNTAXE D'APPEL 

boolean MhwFsIsFile ( char * aPath ); 

ARGUMENTS D'ENTREE 
aPath 

chemin d'acces du fichier ou du directoo'. Le chemin peut etre dom,e en relatif ou en absolu. 
VALEUR DE RETOUR 

TRUE si le chemin represente un fichier existant, FALSE sinon. 
, DESCRIPTION 

Cette fonction indique si un chemin d'acces renresente im r^nUi^^ i u - 

du volume dans lequel on doit chercher Je fiSier """^ ^" '^"'""^ 

1.10.13 MhwFsT.<^niV^r>t.^r:^. 

SYNTAXE D'APPEL 

boolean MhwFsIsDirectory ( char * aPath ); 

ARGUMENTS D'ENTREE 
aPath 

Chemin d'acces du fichier ou du directory. Le chemin peut etre donne en relatif ou en absolu. 
VALEUR DE RETOUR 

TRUE si le chemin repr&ente un directory existant, FALSE sinon. 
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DESCRIPTION 

Cette fonction indique si un chemin d'acc^s repr^sente un directory. Le cherhin peut ou non contenir la 
r^fiSrence du volume dans lequel on doit chercher le directory. 



1.10.14 MhwF sis Accessible 

SYNTAXE D*APPEL 

boolean MhwFsIsAccessible ( char * aPath , CardS anAccessMode ); 

ARGUMENTS D'ENTREE 
aPath 

chemtn d'acces du fichier ou du directory. Le chemin peut etre donn^ en relatif ou en absolu. 
anAccessMode 

Mode d'acces : 

MHW_FS_READ : accds en lecture. 
MHW_FS_WRITE : acc6s en Venture. 

VALEUR DE RETOUR 

TRUE si le thread courant possede les droits d*acc^s sur le fichier/directory, FALSE sinon. 

DESCRIPTION 

Cette fonction indique si le thread courant possfede les droits d'acces en lecture ou en ^criture sur un fichier ou 
un directory. Le chemin peut ou non contenir la reference du volume dans lequel on doit chercher le 
directory. 

1.10.15 MhwFsGetFileLength 

SYNTAXE D'APPEL 

Int32 MhwFsGetFileLength ( char * aPath ); 

ARGUMENTS D*ENTREE 
aPath 

chemin d'acces du fichier. Le chemin peut etre donne en relatif ou en absolu. 

VALEUR DE RETOUR 

taille du fichier si celui-ci existe. 

ERR FS PATH NOT FOUND : le chemin d*acces n*existe pas ou ne repr^sente pas un fichier. 
ERR_FS_ACCESS_DENIED : acc^s en lecture refuse sur le directory contenant le fichier. 

DESCRIPTION 

Cette fonction rend la taille en octets d'un fichier. 

1.10.16 MhwFsFileStreamOpen 

SYNTAXE D'APPEL 

int MhwFsFileStreamOpen ( char * aPath, int aMode ); 

ARGUMENTS D'ENTREE 
aPath 

chemin d'acces du fichier. Le chemin d'acces peut etre donn^ en relatif s'il s'agit d'un fichier existant. II 
doit etre donne obligatoirement en absolu s'il s'agit d'un fichier k creer. 

aMode 

mode d'ouverture du fichier : 
MHW_FS_READ : lecture de donnees. 
MHW_FS_WRITE : ecriture de donnees. 
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MHW_FS_APPEND : ajout de donnees. 

MHW_FS_UPDATE : lecture, remplacement et ajout de donnees. ' ' 

DESCRIPTION 

S3w "pf S^rTtT °" "'Z ^ ^"^"'^^ est autoris^e uniquement en mode 

MHW_FS_ WRITE. En cas de creation de fichier. le chemin doit etre donne en absolu, c'est i dire Hp h,?,7 

ouvert en I^ture le chemin pent etre donne relativement au volume dans lequel il se trouve fexe-^ntr 
Java/ angmireadx ass"). Dans ce cas. le fichier est recherche dans tous les volumes L^onibles drnfu. 
volatile (dernier volume monte) au moins volatile (volume ROM). En retour, la fonction rend Hdemifi^^ 
descnpteur repr^sentant le flux de donnees ou - 1 en cas d'echec. »<lentifiant du 

PAT? Nn^'';Sr;>;^^^ ^J"""'" positionnde ^ I'une des valeurs suivantes . 
ERR_FS_PATH_NOT_FOUND : le chemin indique ne correspond pas k un fichier existant ou dan, . 
du mode d'ouverture MHW FS WRITF lo nt.on»... j » """^i cxisiani ou , dans le cas 

directory existant ^^^^^ correspond pas h one entree inexistante dans un 

ERR_FS^ACCESS_DENIED : Le thread courant ne possede pas les droits en lecture ou en ecriture .... I. 
directory dans lequel on demande a creer le fichier. f ^^ous a ecnture sur le 

LI 0-1 7 MhwFsFileStreamrioQP 

SYNTAXE D'APPEL 

int MhwFsFileStreamCIose ( int aFileDescriptor ); 

ARGUMENTS D'ENTREE 
aFileDescriptor 

descnpteur du flux de donnees. 

DESCRIPTION 

Cette fonction permet de fermer un flux de donnees sur un fichier Si 1*- firinVr a 
donnees contenues dans le buffer de blocage som Sushis 

1.10.18 MhwFsFileStrentnR^^H 

SYNTAXE D'APPEL 

Int32 MhwFsFileStreamRead ( int aFileDescriptor , Card8 aBuffer[] , InG2 aSize ); 

ARGUMENTS D'ENTREE 
aFileDescriptor 

descripteur du flux de donnees 
aBuffer 

adresse du buffer dans lequel doivent etre stock^es les donnees lues. 

a Size 

nombre d'octets k lire. 
VALEUR DE RETOUR 

DESCRIPTION 

Cette fonction permet de lire des donnees dans un fichier ouvert en lecture. 
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1.10,19 MhwFsFileStream Write 

SYNTAXE D'APPEL 

int N4hwFsFileStream Write ( int aFileDescriptor , Card8 aBuffer[] , Int32 aSize ); 

ARGUMENTS D'ENTREE 
aFileDescriptor 

descripteur du flux de donnees. 
aBuffer 

adresse du buffer contenant les doruiees k ecrire. 

aSize 

nombre d'octets h ecrire. 
VALEUR DE RETOUR 

Le code retour de la fonction est nul si roperation s'est d^roulee correctement. 11 vaut -1 si reparation est 
reflisee ou si elle a echou6. 

DESCRIPTION 

Cette fonction perniet d'^crire des donnees dans un fichier ouvert en Venture. 



LI 0.20 MhwFsFileStreamSeek 

SYNTAXE D'APPEL 

Int32 MhwFsFileStreamSeek { int aFileDescriptor , Int32 anOffset , int where ); 

ARGUMENTS D'ENTREE 
aFileDescriptor 

descripteur du flux de donnees. 
anOffset 

offset auquel doit etre positionne le pointeur courant du flux de donnees; 

aMode 

Mode indiquant comment doit etre interpr^t^ Toffset : 

MHW_FS_BEGINNING : Toffset est indiqud par rapport au debut du fichier. 
MHW_FS_CURRENT : I'offset est indiqu^ par rapport a la valeur actuelle du pointeur courant. 
MHW FS END : I'offset est indiqu^ par rapport ^ la fin du fichier. Sa valeur doit etre negative. 

VALEUR DE RETOUR 

La fonction rend la valeur du pointeur courant aprds Toperation ou -1 si Tun des param^tres d'entree a une 
valeur erron^e ou si on tente de positionner le pointeur courant k ime valeur negative. 

DESCRIPTION 

Cette fonction permet de positionner ie pointeur courant d*un flux de donnees. Elle est autoris^e uniquement 
si le fichier a et6 ouvert en mode MHW_FS_READ ou en mode MHW_FS_UPDATE. S'il s'agit d*un flux en 
lecture et si la position demandee ne correspond pas h un octet contenu dans le buffer courant, Toperation 
peut entramer la lecture et eventuellement la decompression de nouvelles donnees. S*il s'agit d'un flux en 
ecriture et si la position demandee ne correspond pas k un octet compris dans le buffer de blocage, le contenu 
du buffer est ^crit dans le fichier puis le buffer de blocage est rempli avec les donnees du bloc correspondant 
a la position demandee. 



1.10.21 MhwFsFileStreamTell 

SYNTAXE D'APPEL 

Int32 MhwFsFileStreamTell ( int aFileDescriptor ); 

ARGUMENTS D'ENTREE 
aFileDescriptor 
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descripteur du flux de donnees. 

VALEUR DE RETOUR 

La fonction rend la valeur du pointeur courant du flux de donnees. 

DESCRIPTION 

Cette fonction rend la valeur du pointeur courant d'un flux de donn^p<: a HJr^ „^ 

debut du fichier du prochain octei a lire ou a ecrire. ' P'^''''^" ^PP^^ 

1.1 0.22 MhwFsFileStreamGetLenff th 

SYNTAXE D'APPEL 

InG2 MhwFsFileStreamGetLength ( int aFileDescriptor ); 

ARGUMENTS D'ENTREE 
aFileDescriptor 

descripteur du flux de donnees. 

VALEUR DE RETOUR 

La fonction rend la longueur totale du flux de donnees. 

DESCRIPTION 

Cette fonction rend la longueur totale en octets d'un flux de donnees. 

1 . 1 0.23 MhwFsInitPersistentStora^ e 

SYNTAXE D'APPEL 

Int32 MhwFsInitPersistentStorage ( Int32 aSize ); 

ARGUMENTS D'ENTREE 
aSize 

Taille maximale en octets reserves aux donnees des fichiers "persistent storage". 
VALEUR DE RETOUR 

ERR NONE : I'operation est acceptee 
ERR_FS_MEMORY : Echec d'allocation memoire 
ERR_FS_DUPLICATE_NAME : Uinitiaiisation a deji ^t^ effectu^e. 

DESCRIPTION 

1-10.24 MhwFsStorePersistent 

SYNTAXE D'APPEL 

Int32 MhwFsStorePersistent ( char *aName, CardS aBufferO , Int32 aSize ); 

ARGUMENTS DENTREE 
aName 

nom du fichier. 
aBuffer 

adresse du buffer contenant les donnees a Ecrire 

aSize 
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VALEUR DE RETOUR 

ERR NONE : reparation est acceptee. 

ERR_FS_MEMORY : Echec d'al location memoire (pour le descripteur du fichier). 
DESCRIPTION 

Cette fonction permet d*ecrire des donnees dans un fichier. Le fichier est cr^e dans le volume "persistent 
storage". Si le fichier n'existe pas, il est ct€6. Si le fichier existe, les donnees qu'il contient sent remplacees 
par les nouvelles donnees. La taille des nouvelles donnees peut etre diff^rente de celle des donnees existantes. 
Le nom du fichier ne doit pas contenir le caractere '/*. 

1.10.25 MhwFsReadPersistent 

SYNTAXE D'APPEL 

Int32 MhwFsReadPersistent ( char *aName, CardS aBuffer[] , Int32 aSize ); 

ARGUMENTS D'ENTREE 
aName 

nom du fichier. 
aBuffer 

adresse du buffer pour stocker les donnees lues. 

aSize 

nombre d*octets a lire. 

VALEUR DE RETOUR 

ERR_NONE : Top^ration est acceptee. 

ERR_FS_PATH__NOT__FOUND : Le fichier sp^cifi6 n'existe pas. 
DESCRIPTION 

Cette fonction permet de lire des donnees dans un fichier du volume "persistent storage". 



1.10.26 MhwFsGetFileEntrv 

SYNTAXE D'APPEL 

FsEntry * MhwFsGetFileEntry ( char *aPath); 

ARGUMENTS D'ENTREE 
aPath 

chemin d*acces au fichier. 
VALEUR DE RETOUR 

La fonction rend Tadresse de la structure d^crivant le fichier ou NULL si le chemin indiqu^ ne correspond 
pas ^ un fichier existant. 

DESCRIPTION 

Cette fonction rend Fadresse du descripteur d'un fichier. 

L 1 0.27 MhwFsGetEntrvBlockCount 

SYNTAXE D'APPEL 

Int32 MhwFsGetEntryBlockCount ( FsEntry *anEntry ); 

ARGUMENTS D'ENTREE 
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anEntry 

adresse du descripteur du fichier. 

VALEUR DE RETOUR 

La fonction rend le nombre de blocs de donnees 
invalide. 



constituant le fichier ou -I si I'adresse passee en entree 



est 



DESCRIPTION 

Cette fonction rend le nombre de blocs de donnees 



constituant un fichier. 



LI 0.28 MhwFsGetE ntrvBlQckT.iV^t 

SYNTAXE D'APPEL 

Int32 MhwFsGetEntryBIocRList ( FsEntry ^entiy, FileBIock blocksC, Int32 blocklndex, Int32 blockCount ); 

ARGUMENTS D'ENTREE 
entry 

adresse du descripteur du fichier 

Blocks 

Tableau de structures FileBIock. 
blocklndex 

Indice du premier bloc. 
blockCount 

Nombre de blocs. 

ARGUMENTS DE SORTIE 
blocks 



VALEUR DE RETOUR 

La fonction rend 0 si I'operation s'est d6roul6e 
echoue. 



DESCRIPTION 

Cette fonction rend la description de blocs de donnees 
constituee de la fa^on suivante : 

typedef struct 
{ 

Cards *ptr; 
Card32 length; 
} FileBIock; 



correctement ou -I si Toperation est reflisee ou si elle a 
constituant un fichier. La structure FileBIock est 



